Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Managing Unknown Objects

Q3UnknownText_GetData

You can use the Q3UnknownText_GetData function to get the data of an unknown text object.

TQ3Status Q3UnknownText_GetData (
TQ3UnknownObject unknownObject, 
TQ3UnknownTextData *unknownTextData);

unknownObject

An unknown text object.

unknownTextData

A pointer to an unknown text data structure.

DESCRIPTION

The Q3UnknownText_GetData function returns, in the objectName and contents fields of the unknown text data structure pointed to by the unknownTextData parameter, pointers to the name and contents of an unknown text object (that is, an unknown object of type kQ3UnknownTypeText) specified by the unknownObject parameter. The contents field of the unknown text data structure points to the data stored in the text metafile, excluding any excess white space and any delimiter characters (that is, outermost parentheses).

Your application is responsible for allocating the memory occupied by the unknownTextData parameter. Q3UnknownText_GetData allocates memory to hold the name and contents pointed to by the fields of that structure. You must make certain to call Q3UnknownText_EmptyData to release the memory allocated by Q3UnknownText_GetData when you are finished using the data.